home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglrect.z / fglrect
Encoding:
Text File  |  2002-10-03  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllRRRReeeecccctttt((((3333GGGG))))                    OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                    ffffggggllllRRRReeeecccctttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllRRRReeeeccccttttdddd,,,, ffffggggllllRRRReeeeccccttttffff,,,, ffffggggllllRRRReeeeccccttttiiii,,,, ffffggggllllRRRReeeeccccttttssss,,,, ffffggggllllRRRReeeeccccttttddddvvvv,,,, ffffggggllllRRRReeeeccccttttffffvvvv,,,, ffffggggllllRRRReeeeccccttttiiiivvvv,,,,
  10.      ffffggggllllRRRReeeeccccttttssssvvvv - draw a rectangle
  11.  
  12.  
  13. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      SUBROUTINE ffffggggllllRRRReeeeccccttttdddd( REAL*4 _x_1,
  15.                           REAL*4 _y_1,
  16.                           REAL*4 _x_2,
  17.                           REAL*4 _y_2 )
  18.      SUBROUTINE ffffggggllllRRRReeeeccccttttffff( REAL*4 _x_1,
  19.                           REAL*4 _y_1,
  20.                           REAL*4 _x_2,
  21.                           REAL*4 _y_2 )
  22.      SUBROUTINE ffffggggllllRRRReeeeccccttttiiii( INTEGER*4 _x_1,
  23.                           INTEGER*4 _y_1,
  24.                           INTEGER*4 _x_2,
  25.                           INTEGER*4 _y_2 )
  26.      SUBROUTINE ffffggggllllRRRReeeeccccttttssss( INTEGER*2 _x_1,
  27.                           INTEGER*2 _y_1,
  28.                           INTEGER*2 _x_2,
  29.                           INTEGER*2 _y_2 )
  30.  
  31.  
  32. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  33.      _x_1, _y_1 Specify one vertex of a rectangle.
  34.  
  35.      _x_2, _y_2 Specify the opposite vertex of the rectangle.
  36.  
  37. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  38.      SUBROUTINE ffffggggllllRRRReeeeccccttttddddvvvv( CHARACTER*8 _v_1,
  39.                            CHARACTER*8 _v_2 )
  40.      SUBROUTINE ffffggggllllRRRReeeeccccttttffffvvvv( CHARACTER*8 _v_1,
  41.                            CHARACTER*8 _v_2 )
  42.      SUBROUTINE ffffggggllllRRRReeeeccccttttiiiivvvv( CHARACTER*8 _v_1,
  43.                            CHARACTER*8 _v_2 )
  44.      SUBROUTINE ffffggggllllRRRReeeeccccttttssssvvvv( CHARACTER*8 _v_1,
  45.                            CHARACTER*8 _v_2 )
  46.  
  47.  
  48. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  49.      _v_1   Specifies a pointer to one vertex of a rectangle.
  50.  
  51.      _v_2   Specifies a pointer to the opposite vertex of the rectangle.
  52.  
  53. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  54.      ffffggggllllRRRReeeecccctttt supports efficient specification of rectangles as two corner
  55.      points.  Each rectangle command takes four arguments, organized either as
  56.      two consecutive pairs of (_x,_y) coordinates, or as two pointers to arrays,
  57.      each containing an (_x,_y) pair.  The resulting rectangle is defined in the
  58.      _z = 0 plane.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllRRRReeeecccctttt((((3333GGGG))))                    OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                    ffffggggllllRRRReeeecccctttt((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      ffffggggllllRRRReeeecccctttt(_x_1, _y_1, _x_2, _y_2) is exactly equivalent to the following sequence:
  75.  
  76.           glBegin(GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN);
  77.           glVertex2(_x_1, _y_1);
  78.           glVertex2(_x_2, _y_1);
  79.           glVertex2(_x_2, _y_2);
  80.           glVertex2(_x_1, _y_2);
  81.           glEnd();
  82.  
  83.      Note that if the second vertex is above and to the right of the first
  84.      vertex, the rectangle is constructed with a counterclockwise winding.
  85.  
  86. EEEERRRRRRRROOOORRRRSSSS
  87.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllRRRReeeecccctttt is executed between the
  88.      execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ffffggggllllEEEEnnnndddd.
  89.  
  90.  
  91. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  92.      ffffggggllllBBBBeeeeggggiiiinnnn, ffffggggllllVVVVeeeerrrrtttteeeexxxx
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.